chore(react-router): Bump minimum react-router version to 8.3.0 by wobsoriano · Pull Request #9229 · clerk/javascript

wobsoriano · 2026-07-23T20:58:55Z

Description

Bumps the minimum supported React Router v8 version to 8.3.0. Earlier v8 releases ship separate development and production export conditions, so during react-router dev the externalized @clerk/react-router package resolved a different react-router instance than the app, breaking the Router context (remix-run/react-router#15232). React Router 8.3.0 fixes this, so upgrading removes the need for workarounds like ssr.noExternal: ['@clerk/react-router']. The v7 range (^7.9.0) is unchanged.

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

vercel · 2026-07-23T20:59:01Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jul 24, 2026 11:16pm
swingset	Ready	Preview, Comment	Jul 24, 2026 11:16pm

changeset-bot · 2026-07-23T20:59:02Z

🦋 Changeset detected

Latest commit: 8a705bf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@clerk/react-router	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

pkg-pr-new · 2026-07-23T21:02:01Z

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9229

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9229

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9229

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9229

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9229

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9229

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9229

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9229

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9229

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9229

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9229

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9229

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9229

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9229

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9229

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9229

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9229

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9229

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9229

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9229

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9229

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9229

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9229

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9229

commit: 8a705bf

github-actions · 2026-07-24T17:59:24Z

API Changes Report

Generated by Break Check on 2026-07-24T23:16:37.484Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	0
🔴 Breaking changes	0
🟡 Non-breaking changes	0
🟢 Additions	0

No API Changes Detected

All packages have stable APIs with no detected changes.

Report generated by Break Check

_{Last ran on 8a705bf.}

coderabbitai · 2026-07-24T18:03:17Z

📝 Walkthrough

Walkthrough

React Router-related template dependencies were upgraded from 8.0.1 to 8.3.0. The package peer dependency range now permits React Router ^8.3.0 alongside ^7.9.0. Changeset metadata records the minimum React Router v8 version and a minor package change. The React Router Node Vite configuration no longer uses the command parameter or conditionally configures SSR noExternal behavior.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly summarizes the main change: raising the minimum React Router version to 8.3.0.
Description check	✅ Passed	The description directly matches the changeset and explains the version bump and SSR workaround removal.

_{Comment @coderabbitai help to get the list of available commands.}

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@integration/templates/react-router-node/package.json`:
- Line 13: Update the `@react-router/serve` dependency version in package.json
from 8.3.01 to the valid 8.3.0 release, preserving the rest of the dependency
configuration.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e1761c-9ca4-44e0-bdf2-c04f6e0ad431

📥 Commits

Reviewing files that changed from the base of the PR and between 41c323a and 666fe3c.

📒 Files selected for processing (3)

integration/templates/react-router-node/package.json
integration/templates/react-router-node/vite.config.ts
packages/react-router/package.json

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

clerk/clerk_go (manual)
clerk/dashboard (manual)
clerk/accounts (manual)
clerk/backoffice (manual)
clerk/clerk (manual) → reviewed against open PR #3026 rob/react-router-v3-fix instead of the default branch
clerk/clerk-docs (manual)
clerk/cloudflare-workers (manual)
clerk/clerk-ios (auto-detected)
clerk/cli (auto-detected)
clerk/clerk-android (auto-detected)

chore(react-router): Bump minimum react-router version to 8.3.0

29ddf29

Merge branch 'main' into rob/react-router-v3-fix

68676f0

github-actions Bot added integration react-router labels Jul 23, 2026

vercel Bot deployed to Preview – clerk-js-sandbox July 23, 2026 21:00 View deployment

vercel Bot deployed to Preview – swingset July 23, 2026 21:01 View deployment

Merge branch 'main' into rob/react-router-v3-fix

7083a8d

vercel Bot deployed to Preview – clerk-js-sandbox July 24, 2026 16:54 View deployment

vercel Bot deployed to Preview – swingset July 24, 2026 16:56 View deployment

Merge branch 'main' into rob/react-router-v3-fix

666fe3c

vercel Bot deployed to Preview – clerk-js-sandbox July 24, 2026 17:08 View deployment

vercel Bot deployed to Preview – swingset July 24, 2026 17:10 View deployment

wobsoriano marked this pull request as ready for review July 24, 2026 17:55

coderabbitai Bot reviewed Jul 24, 2026

View reviewed changes

Comment thread integration/templates/react-router-node/package.json Outdated

Merge branch 'main' into rob/react-router-v3-fix

41942ec

vercel Bot deployed to Preview – clerk-js-sandbox July 24, 2026 22:27 View deployment

fix version

193bdbe

vercel Bot deployed to Preview – clerk-js-sandbox July 24, 2026 22:29 View deployment

vercel Bot deployed to Preview – swingset July 24, 2026 22:30 View deployment

chore: add changeset

8a705bf

vercel Bot deployed to Preview – clerk-js-sandbox July 24, 2026 23:14 View deployment

vercel Bot deployed to Preview – swingset July 24, 2026 23:16 View deployment

alexcarpenter approved these changes Jul 24, 2026

View reviewed changes

wobsoriano merged commit 74965eb into main Jul 24, 2026
53 checks passed

wobsoriano deleted the rob/react-router-v3-fix branch July 24, 2026 23:26

clerk-cookie mentioned this pull request Jul 24, 2026

ci(repo): Version packages #9246

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

chore(react-router): Bump minimum react-router version to 8.3.0#9229

chore(react-router): Bump minimum react-router version to 8.3.0#9229
wobsoriano merged 7 commits into
mainfrom
rob/react-router-v3-fix

wobsoriano commented Jul 23, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jul 23, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Jul 23, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Jul 23, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 24, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 24, 2026 •

edited

Loading

Walkthrough

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

wobsoriano commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Uh oh!

vercel Bot commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-new Bot commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Changes Report

Summary

No API Changes Detected

Uh oh!

coderabbitai Bot commented Jul 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

wobsoriano commented Jul 23, 2026 •

edited

Loading

vercel Bot commented Jul 23, 2026 •

edited

Loading

changeset-bot Bot commented Jul 23, 2026 •

edited

Loading

pkg-pr-new Bot commented Jul 23, 2026 •

edited

Loading

github-actions Bot commented Jul 24, 2026 •

edited

Loading

coderabbitai Bot commented Jul 24, 2026 •

edited

Loading